---
title: Change Log
---

## 1.2.7

1. fix: rtl
2. fix: custom render node offset NaN
3. fix: swipe behavior in non-webkit browsers

## 1.2.6

1. fix: 移动端在 rax 类的框架中图片宽高单位被转换问题

## 1.2.5

1. fix: Chrome 125 版本以上无法拖动的问题

## 1.2.4

1. feat: PhotoView 子组件支持导出 ref
2. fix: isActive 属性判断问题

## 1.2.3

feat: 提供 `onClick` `onDoubleClick` 可选的绑定事件

## 1.2.1

fix: 自定义渲染例子修复
fix: maskOpacity 设置 null 背景不响应下拉变化

## 1.2.0

feat: configurable react portal container

## 1.1.2

fix: Force LTR only

## 1.1.1

fix: 类型问题

## 1.1.0

1. feat: PhotoView 新增 `overlay` 参数
2. fix: 移除 css sourceMap
3. fix: 修复图片右键触发拖动的问题

## 1.0.0

1. fix: `loadingElement` 位置问题
2. fix: 图片放大限制优化
3. fix: 个别机型中图片无法预览问题

## 1.0.0-beta.8

1. fix: `onScale` API 调用后缩放位置不准确的问题
2. fix: 调整图片移除后不保留 `scale` 和 `rotate` 状态

## 1.0.0-beta.7

1. fix: 长图模式 BUG 修复及新增示例
2. fix: 弹性触边动画优化
3. fix: `scale`、`rotate` 为空问题
4. style: 包尺寸优化

## 1.0.0-beta.6

1. feat: 添加 API `afterClose`
2. fix: 细节修复

## 1.0.0-beta.5

fix: cover 动画细节调整

## 1.0.0-beta.4

features:

1. 完美衔接打开/关闭动画
2. 自动识别 `object-fit` 图像填充模式动画
3. 新增 `speed`、`easing` API
4. 其他元素动画 `opacity` 降级处理

break changes:

1. 调整图片居中逻辑
2. 更改 CSS 少许名称

fix:

1. `next.js` 中导入报错
2. 放大后关闭动画指向问题

## 1.0.0-beta.0

基于 `hooks` 重构逻辑

features:

1. 模拟物理滚动预览/带回弹
2. 调整缩放后延迟更新宽/高
3. 支持 `loop` 循环预览
4. 支持 `render` 自定义预览元素
5. 新增参数 `maskOpacity` 支持自定义背景默认透明度

break changes:

1. `PhotoConsumer ` 名称更改为 `PhotoView`
2. `DataType` 移除 `intro` 字段，移除参数 `introVisible`
3. `viewClassName` 参数名更改为 `photoWrapClassName`
4. `imageClassName` 参数名更改为 `photoClassName`
5. `DataType` 中 `key` 为必填字段

others:

修复诸多细节问题
